介绍

  • 可以用来替代以 element.className 访问和操作 CSS 类名的方式
  • 返回元素 class 属性的 DOMTokenList,本身只读,但是可以通过自身的 add / remove 等方法修改元素的 class 属性
  • 若元素的 class 属性未设置或者为空,则 classList.length 为 0

用法

add( String [, String [, ...]] )

添加任意数量的类名,若类名已存在则会被忽略。

const div = document.createElement('div');
const cls = ["foo", "bar"];

div.className = 'foo'; // 'foo'
div.classList.add(...cls); // 'foo bar'
div.classList.add('bar baz'); // 'foo bar baz'

remove( String [, String [, ...]] )

删除任意数量的类名,若类名不存在,也不会抛出异常。

// 起始:'foo bar baz'
div.classList.remove("foo"); // 'bar baz'

item( Number )

根据索引返回相应的类名。

// 起始:'bar baz'
console.log(div.classList.item(1)); // 输出:'baz'

toggle( String [, force] )

当只有一个参数时:

  • 若类名已存在,则删除指定的类名并返回 false
  • 若类名不存在,则添加指定的类名并返回 true

当有两个参数时:

  • 若第二个参数的值为 true,则添加指定的类名
  • 若第二个参数的值为 false,则删除指定的类名
// 起始:'bar baz'
div.classList.toggle("foo"); // 'foo bar baz'
div.classList.toggle("foo"); // 'bar baz'
div.classList.toggle("foo", 2 < 1 ); // 'bar baz'

contains( String )

检查指定的类名是否存在。

// 起始:'bar baz'
console.log(div.classList.contains("foo")); // 输出:false

replace( oldClass, newClass )

用新的类名替换指定的类名。

// 起始:'bar baz'
div.classList.replace("bar", "foo");  // 'foo baz'

兼容性

IE 9 及以下不支持


逆风不倒
0 声望0 粉丝

Temet Nosce